home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / graphics / 256 / imgshow.doc next >
Text File  |  1989-02-01  |  7KB  |  180 lines
  1. ======================================================================
  2.                           ".IMG Slide Show"
  3.                              IMGSHOW.PRG
  4.                    (c) Copyright 1989 Migraph, Inc.
  5.                           All Rights Reserved
  6.                              Version 1.1                      1/31/89
  7. ======================================================================
  8.  
  9.                    This program is NOT public domain,
  10.                  but may be distributed free of charge
  11.             provided this doc file accompanies the program.
  12.  
  13. Distribution with commercial applications is FORBIDDEN, unless prior
  14. written consent is acquired from Migraph, Inc.
  15.  
  16. ----------------------------------------------------------------------
  17.  
  18.      This .IMG Slide Show program (IMGSHOW.PRG) allows the viewing of
  19. monochrome .IMG files on any resolution ST. (Low, Med, Hi & Viking 1)
  20.  
  21.     The user has control over speed, titles, slide order and other
  22. attributes through the use of an optional script file. You may specify
  23. multiple search paths and/or filenames with full wildcard support.
  24.  
  25.  
  26.         * Optional file information about each slide
  27.         * Black or white background
  28.         * Cycling or non-cycling slide show
  29.         * Key pause after each image or controllable time delay
  30.  
  31.  
  32. ----------------------------------------------------------------------
  33. Script files:
  34. ----------------------------------------------------------------------
  35.  
  36.     When the slide show is run, the command line is first checked for
  37. pathnames and/or filenames. If found, the slide show proceeds. If not,
  38. the current directory is searched for the script file "IMGSHOW.LST".
  39. If found, the script file is parsed and the slide show continues.
  40. Otherwise, "#*.img" is used as the search path, where '#' is the
  41. current directory. When this is the case, the slides in the directory
  42. will be shown in alphabetical order and you will be presented with a
  43. dialog box to choose display options from.
  44.  
  45.     Script files may contain the following fields (all are optional,
  46. and can be in any order), default settings are given in brackets. The
  47. user should specify 'Y','y','N', or 'n' following the field to indicate
  48. whether they would like the option enabled or suppressed.
  49.  
  50.       INFO:           Indicate whether to show file information [no]
  51.       TINYINF:        Shall info be displayed in a line at the top of
  52.                       the screen or in a box at the right hand side
  53.                       [use box except in low-res]
  54.       BLACK:          Indicate whether the background behind the slide
  55.                       shall be black or white [no]
  56.       CYCLE:          Shall the slideshow start over at end [no]
  57.       KEY:            Wait for keystroke before displaying next slide [yes]
  58.       SPEED:          Value of 1,2, or 3 representing short, medium and
  59.                       long screen delays before displaying next slide [2]
  60.  
  61. The next two fields don't take a letter after the field name:
  62.  
  63.       PATH:
  64.       FILE:
  65.  
  66.     The 'PATH:' field consists of a list of pathnames to be searched
  67. one after another. If a full pathname is present (ie. "A:\IMGS\*.img"),
  68. then that is the search path used. If a path is present without a filename
  69. ("A:\IMGS\"), the FILE list is scanned one at a time to complete the full
  70. pathname. Wildcards may be used in the filename only. Up to 10 paths may be
  71. specified.
  72.  
  73.     The 'FILE:' field consists of a list of filenames (and filenames
  74. ONLY, paths will be stripped, ie. "A:\IMGS\*.img" will be read as "*.img")
  75. to be processed one at a time. Again, you may include wildcards or use 
  76. full filenames.
  77.  
  78. Field names MUST BE UPPER CASE and MUST CONTAIN THE COLON.
  79.  
  80.     Blank lines are ignored and anything after a semi-colon on a line
  81. is considered to be a comment.
  82.  
  83. The following is a sample script file:
  84. --------------------------------------
  85.  
  86. ; Sample IMGSHOW script file
  87. ; anything after a semi-colon is a comment
  88. ;
  89. INFO:Y  ; show file info. default is no
  90. BLACK:Y ; use a black background. default is no
  91. KEY:Y   ; wait for keypress after each slide. default is pause
  92. ;
  93. PATH:
  94. c:\pics\*.img
  95. c:\images\
  96. f:\imgs\touchup.img
  97. ;
  98. FILE:
  99. tiger?.img
  100. ss*.img
  101.  
  102.  
  103.     The above script file will display the pictures with file
  104. information on top of a black background. Slides will not advance
  105. without a keypress. The first PATH entry will cause all .img files
  106. found in the "pics" folder on drive C to be displayed. Since this is
  107. a full pathname, the file list is ignored for this path. After this,
  108. the second PATH entry is processed. Since it is a pathname only
  109. (no filename), each of the FILE entries in turn is appended to the
  110. path to form complete search pathnames (ie. the first path searched
  111. will be "c:\images\tiger?.img", then "c:\images\ss*.img"). Finally,
  112. the third PATH entry is processed. It's a complete filename and the
  113. FILE list is ignored.
  114.  
  115.  
  116. ----------------------------------------------------------------------
  117. The Command Line:
  118. ----------------------------------------------------------------------
  119.  
  120.     'PATH:' entries can be entered on the command line of various
  121. shells (ie. GULAM, MSH). You may need to enclose your paths in single
  122. quotes depending upon your shell.
  123.  
  124.  
  125. ----------------------------------------------------------------------
  126. Install Application:
  127. ----------------------------------------------------------------------
  128.  
  129.     You may also use Install Application from the desktop to install
  130. IMGSHOW.PRG as file type IMG.  This will let you double-click an .IMG
  131. file to display it.
  132.  
  133.  
  134. ----------------------------------------------------------------------
  135. Keyboard commands:
  136. ----------------------------------------------------------------------
  137.  
  138.     The following key commands are accepted while the slideshow is
  139. running:
  140.  
  141.         SPACE.......... Pause at the current pic, any key resumes
  142.                         (does not pause if key pause is in effect)
  143.  
  144.         HELP........... Toggle file info on/off
  145.  
  146.         UNDO........... Toggle background color between black and white
  147.  
  148.         Up Arrow....... Display previous slide
  149.  
  150.         F1............. Show a screen of other information
  151.  
  152.         ESCAPE......... Abort slideshow
  153.  
  154.         Holding down the left mouse button also aborts the slideshow.
  155.  
  156. Note: Some .IMG files take a while to load and sometimes keypresses
  157. won't seem to take effect until after the next slide.  Also, keys
  158. should not be pressed too quickly after one another or commands may be
  159. lost.
  160.  
  161. ----------------------------------------------------------------------
  162.  
  163.         We hope this program makes your use of .IMG files more
  164.         enjoyable and productive. Comments or problems may be
  165.         addressed to:
  166.  
  167.  
  168.         Migraph, Inc.
  169.         200 S 333rd St (220)
  170.         Federal Way, Wa. 98003
  171.  
  172.         phone lines 9-5 PST weekdays:
  173.         1-800-223-3729  Order line
  174.         1-206-838-4677  Product support
  175.  
  176.         Online support -
  177.         GEnie address: MIGRAPH-TECH
  178.         Category 28 in ST Roundtable
  179.  
  180.